---- Effects Guide ----

Effects are occurrences that can happen to different types of entities (cells, groups, factions, etc) when an event occurs within the simulation. These can affect the entity in multiple ways depending on the type of effect.

Here's a list of the current types of effects (more to be added in future versions) and how they work:

- 'add_group_knowledge'
    Assigns the specified knowledge to the specified group, and sets the knowledge's level limit to the specified value (integer value between 1 and 10000). the format of the effect is as follows: 'add_group_knowledge:<knowledge_id>,<levelLimit>'
    These are valid target group types:
    - 'this': the cell group this effect targets

    Examples: 'add_group_knowledge:agriculture_knowledge,10', 'add_group_knowledge:shipbuilding_knowledge,30'

- 'remove_group_knowledge'
    Removes the specified knowledge from the specified group. the format of the effect is as follows: 'remove_group_knowledge:<knowledge_id>'
    NOTE: Try make sure that no more than one 'effector' can remove a particular knowledge at any given time.

    Examples: 'remove_group_knowledge:agriculture_knowledge', 'remove_group_knowledge:shipbuilding_knowledge'

- 'modify_group_knowledge_limit'
    Assigns the specified knowledge to the specified group, and modify the knowledge's current level limit by adding the specified value (integer value between -10000 and 10000). the format of the effect is as follows: 'modify_group_knowledge_limit:<knowledge_id>,<levelLimitDelta>'
    NOTE: This effect cannot decrease a knowledge level limit below 1 nor it can increase a specific limit above 10000.

    Examples: 'modify_group_knowledge_limit:shipbuilding_knowledge,20', 'modify_group_knowledge_limit:shipbuilding_knowledge,-20'

- 'apply_cell_arability_modifier'
    Applies the specified arability modifier (value between -1 and 1) to the group, increasing or decreasing the arability on the target cell. the format of the effect is as follows: 'apply_cell_arability_modifier:<rangeDelta>'
    NOTE: This effect cannot decrease the arability below 0 or increase it above 1.

    Examples: 'apply_cell_arability_modifier:0.5', 'apply_cell_arability_modifier:-0.5'

- 'apply_cell_accessibility_modifier'
    Applies the specified accessibility modifier (value between -1 and 1) to the group, increasing or decreasing the accessibility on the target cell. the format of the effect is as follows: 'apply_cell_accessibility_modifier:<rangeDelta>'
    NOTE: This effect cannot decrease the accessibility below 0 or increase it above 1.

    Examples: 'apply_cell_accessibility_modifier:0.5', 'apply_cell_accessibility_modifier:-0.5'

- 'apply_group_navigation_range_modifier'
    Applies the specified navigation range modifier (value between -1 and 1) to the group, giving longer routes a greater chance of success. the format of the effect is as follows: 'apply_group_navigation_range_modifier:<rangeDelta>'
    NOTE: This effect cannot decrease the group navigation range modifier below 0.

    Examples: 'apply_group_navigation_range_modifier:0.5', 'apply_group_navigation_range_modifier:-0.5'

- 'add_group_activity'
    Assigns the specified activity to the specified group. the format of the effect is as follows: 'add_group_activity:<activity_id>'

    Examples: 'add_group_activity:farming'

- 'remove_group_activity'
    Removes the specified activity from the specified group. the format of the effect is as follows: 'remove_group_activity:<activity_id>'
    NOTE: Try make sure that no more than one 'effector' can remove a particular activity at any given time.

    Examples: 'remove_group_activity:farming'

- 'add_group_skill'
    Assigns the specified skill to the specified group. the format of the effect is as follows: 'add_group_skill:<activity_id>'
    These are valid target group types:
    - 'this': the cell group this effect targets

    Examples: 'add_group_skill:seafaring'

- 'remove_group_skill'
    Removes the specified skill from the specified group. the format of the effect is as follows: 'remove_group_skill:<activity_id>'
    NOTE: Try make sure that no more than one 'effector' can remove a particular activity at any given time.

    Examples: 'remove_group_skill:seafaring'

- 'add_group_property'
    Assigns the specified property to the specified group. the format of the effect is as follows: 'add_group_property:<property>'

    Examples: 'add_group_property:CAN_FORM_POLITY:tribe'

- 'remove_group_property'
    Removes the specified property from the specified group. the format of the effect is as follows: 'remove_group_property:<property>'
    NOTE: Try make sure that no more than one 'effector' can remove a particular property at any given time.

    Examples: 'remove_group_property:CAN_FORM_POLITY:tribe'

--
